home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / comms / other / slrn / slrn_src / readme < prev    next >
Text File  |  1999-05-14  |  6KB  |  135 lines
  1. Special notes:
  2.  
  3.     For Offline reading, see the slrnpull subdirectory.
  4.  
  5.     VMS users:   Read doc/VMSNOTES.TXT.  Also use VMSMAKE.COM and note
  6.                  that  names like .jnewsrc should be read as jnews.rc, 
  7.          etc...
  8.  
  9.     OS/2 users:  Read doc/README.os2 and use the makefile 
  10.                  called Makefile.os2 (in src/)
  11.  
  12.     Windows 95 and Windows NT users: (including CYGWIN32 and MINGW32 users)
  13.                  Read doc/README.w32 and use the makefile 
  14.                  called Makefile.w95 or Makefile.g32 (in src/)
  15.  
  16.     The man page is rather old.  Be sure to read the sample slrn.rc
  17.     file as well as changes.txt since these are kept current.
  18.  
  19.     See also doc/INSTALL for more installation tips--- especially for
  20.     a multiuser system.
  21.  
  22. ==========================================================================
  23.  
  24. To build slrn, build the S-Lang library first.  S-Lang is available
  25. from space.mit.edu in pub/davis/slang.  slrn uses S-Lang for most of
  26. the dirty work such as keymaps, terminal i/o, and screen management.
  27. Once S-Lang has been compiled, compile slrn.  Under Unix, this is
  28. accomplished by running the configure script via:
  29.  
  30.     ./configure
  31.     [edit src/slrnfeat.h and src/Makefile]
  32.     make
  33.     make install
  34.  
  35. Notes:
  36.  
  37.    *  It may be necessary to edit the Makefile in src/Makefile.  
  38.    *  Be sure to look at src/sysconf.h after running the configure script 
  39.        but BEFORE running make.
  40.    *  If you want support for a local news spool or for inews, edit 
  41.        src/slrnfeat.h. 
  42.    *  The executable will be created in src/objs.
  43.    *  To build slrnpull for offline reading, read the documents in the
  44.       slrnpull subdirectory first.  You will also need to edit
  45.       src/slrnfeat.h.  Then do `make slrnpull'.
  46.  
  47. Once slrn has been created, you will need to creat a .jnewsrc file in your
  48. $HOME directory.  The simplist way to do this is to simply do:
  49.  
  50.     cp $HOME/.newsrc $HOME/.jnewsrc
  51.  
  52.    [Actually, slrn will do this for you automatically.  If no newsrc file is
  53.     specified, and .newsrc exists, it will create .jnewsrc from .newsrc]
  54.     
  55. slrn will use a different name for this file while it is under development.
  56. Finally, make sure the environment variable NNTPSERVER is set to point to
  57. your news server (e.g., setenv NNTPSERVER nntp.where-ever.com).  This is
  58. only necessary when using NNTP.
  59.  
  60.    [ If you do not already have a .newsrc file, it will be necessary to create
  61.      one.  To do so, at the unix prompt, type:
  62.      
  63.         slrn -f .jnewsrc -create
  64.     
  65.      This starts the newsreader and retrieves all active newsgroups from the
  66.      news server.  The act of retrieving all groups can be quite slow for
  67.      slow connections.  Fortunately, this only happens when the create flag
  68.      is used.
  69.      
  70.      From within the news reader, you may subscribe to
  71.      desired groups.  Press the `L'  (capital-L!!) key to list all groups
  72.      matching a specified pattern, e.g., comp.*unix*.
  73.      
  74.      Use the `s' key to subscribe.
  75.    ]
  76.  
  77. For run-time configuration of slrn such as new keybindings, change in
  78. location of local spool directories, etc. copy the file `slrn.rc' to your
  79. home directory and rename it `.slrnrc' (Unix-- VMS and OS/2 use a different
  80. name).  Edit this file to change the keybindings and to associate different
  81. newsrc files with different servers, etc...
  82.  
  83. To post articles, slrn will look for the following environment variables for
  84. an editor:
  85.  
  86.     SLANG_EDITOR
  87.     EDITOR
  88.     VISUAL
  89.     
  90. If it fails, it will resort  to vi.  `SLANG_EDITOR' is the most versatile
  91. since one can define it to include a command line.  For example, if JED is
  92. your editor, use:
  93.  
  94.     setenv SLANG_EDITOR 'jed %s -g %d -tmp'
  95.     
  96. That's it, type: slrn
  97. Also, try: slrn --help
  98.  
  99.    [If you have a color terminal, use `./slrn -C'.  You may need to change
  100.     the colors by setting them in your .slrnrc file.  If you run under
  101.     X Windows, you may consider getting a good color Xterm such as rxvt.
  102.     (color_xterm itself is somewhat buggy so I recommend rxvt.  See
  103.     http://space.mit.edu/~davis for pointers to rxvt.]
  104.  
  105. After connecting to the server and getting news for the subscribed groups in
  106. you .jnewsrc file, slrn will enter full screen mode listing the newsgroups
  107. that you have subscribed to.  Use the UP/DOWN (^P/^N) arrow keys to move
  108. from one group to another.  To read news from that group, press the SPACE
  109. bar or simply hit RETURN.
  110.  
  111. slrn will display the headers for unread articles after getting the required
  112. headers for the group from the server.  Use the UP/DOWN arrow keys to move
  113. from one to the other.  To delete the current header (i.e., mark as read),
  114. hit the `d' key.  `u' will undelete the article.  To read the article under
  115. the cursor, press RETURN or SPACE.  The screen will split into two windows--
  116. a small one for the headers and a large one for the article.  Press SPACE to
  117. scroll through the article and `b' to page backwards.  The `t' key may be
  118. used to toggle hiding of selected headers.
  119.  
  120. The `f' key may be used to followup on the article.  `q' will return to the
  121. list of newsgroups.  Also, one may use the `n' key to go to thye next unread
  122. article.  If there are no more unread articles, pressing `n' will also take
  123. you to the next group.  Press the arrow keys to choose one.
  124.  
  125. At the group level, a new message may be posted by using the `p' key.
  126.  
  127. Enjoy.  However, since this slrn is still in its infancy and is still under
  128. development, please send me your comments regarding the user interface.
  129.  
  130. I follow the news.software.readers newsgroup.  Feel free to post questions
  131. there.  Before posting, read the files FAQ, KILL_FAQ, score.txt.  Finally
  132. look at the sample slrn.rc file.
  133.  
  134. davis@space.mit.edu
  135.